home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / util / misc / SplitIndex125.readme < prev    next >
Encoding:
Text File  |  1996-10-11  |  3.1 KB  |  99 lines
  1. Short:    Splits Aminet Index to dir & sub dir
  2. Author:   peter.ashford@stonebow.otago.ac.nz (Peter Ashford)
  3. Uploader: michaelj@earthlight.co.nz (Michael Johnstone)
  4. Type:     util/misc
  5. Replaces: util/misc/splitindex12.lha
  6.  
  7. SplitIndex.doc - Documentation for SplitIndex V1.25
  8. ===================================================
  9.  
  10. (29-Sep-96)
  11. ===========
  12.  
  13. Disclaimer:
  14. -----------
  15.  
  16. This program is freeware - copy/use it to your heart's content, but
  17. remember: if you use the SplitIndex and your computer explodes, you get
  18. invaded by martians, or any other unpleasant occurance befalls you, it's
  19. not my fault! :)
  20.  
  21. It seems to run properly, but...  (everyone repeat the mantra) "I use PD
  22. software at my own risk..."
  23.  
  24.  
  25. What Does It Do?
  26. ----------------
  27.  
  28. The program takes an aminet index file and splits it into several
  29. sub-indexes by aminet directory, i.e.  from your INDEX file, you create
  30. list.biz, list.comm, ...  list.util.  etc...  This is usefull for those of
  31. us without enough memory to have the whole index in a text reader at once.
  32.  
  33. This program was based on an AREXX script by Andreas Arleving which did
  34. exactly the same thing - So why did I make SplitIndex????
  35.  
  36. Well, Running Andreas's script took 1 hour and 40 minutes on my rather humble
  37. 68000 based 2000 - SplitIndex (being written in C) did it in about 4
  38. minutes. 
  39.  
  40.  
  41. Usage:
  42. ------
  43.  
  44. SplitIndex is CLI only - if it is run from WB, it will do nothing.  Command
  45. format is:
  46.  
  47. SplitIndex [SUB] <INDEXFILE> <OUTFILE>
  48.  
  49. Where <INDEXFILE> is the name of the aminet index to split and <OUTFILE> is
  50. the prefix for the sub indexes to be created, eg:
  51.  
  52. SplitIndex INDEX output/List
  53.  
  54. Typing 'SplitIndex ?' will list the command format and
  55.  
  56. SplitIndex SUB INDEX output/List
  57.  
  58. will split the index file by Aminet subdirectories rather than Aminet parent
  59. directories, to produce smaller output files.
  60.  
  61.  
  62. History:
  63. --------
  64. V1.0    Initial release.
  65.  
  66. V1.2    Added SUB keyword which splits the index up by aminet 
  67.         directory + subdirectory for even smaller output files.
  68.  
  69. V1.25   Modified the program to handle the full-length aminet indexes which 
  70.         are found in aminet/info/index.  I had just assumed that INDEX files
  71.         were always 80 characters wide, and this was hard coded into the 
  72.         program.  Thanks to Matteo Taveggia, for pointing out that this
  73.         wasn't the case  8-)
  74.  
  75.  
  76. Personal Notes:
  77. ---------------
  78.  
  79. * Thanks to Andreas Arleving for releasing his AREXX script to Aminet - my
  80. program is based largely on his script.
  81.  
  82. * Comments, criticisms, suggestions and bug reports would be very much
  83. appreciated.
  84.  
  85. email:          peter.ashford@stonebow.otago.ac.nz
  86. snail mail:     c/- 115 Glenpark Ave, Dunedin, New Zealand.
  87.  
  88.  
  89. ============================= Archive contents =============================
  90.  
  91. Original  Packed Ratio    Date     Time    Name
  92. -------- ------- ----- --------- --------  -------------
  93.    10696    6811 36.3% 18-Sep-96 23:10:00  SplitIndex
  94.     2466    1248 49.3% 18-Sep-96 23:30:20  SplitIndex.doc
  95.     1810    1282 29.1% 18-Sep-96 23:22:34  SplitIndex.doc.info
  96.      554     321 42.0% 29-Aug-96 21:24:32  SplitIndex.info
  97. -------- ------- ----- --------- --------
  98.    15526    9662 37.7% 03-Oct-96 01:48:00   4 files
  99.